home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / spmate12 / readme.doc < prev    next >
Text File  |  1993-10-03  |  12KB  |  338 lines
  1.                   WELCOME TO Spelmate V1.2 FOR WINDOWS
  2.                   ------------------------------------
  3.  
  4. This README file contains important, last minute information about
  5. Spelmate V1.2 
  6.  
  7.  
  8. TABLE OF CONTENTS
  9. -----------------
  10.   1. What is Spelmate
  11.   2. How to Get Help
  12.   3. Installation
  13.   4. Important Notes
  14.   5. Files on the Disk(s)
  15.   6. Why Register?
  16.   7. History
  17.  
  18.  1. What is Spelmate
  19. --------------------
  20.  
  21. Spelmate is a DLL (Dynamic Link Library) that you can use to add spell
  22. checking to your Windows application. Because it is a DLL it can be called
  23. from any programming system that support DLL's including C,C++, Pascal,
  24. and Visual Basic.
  25.  
  26. Spelmate is available in American and British versions.
  27.  
  28. There is no royalty associated with Spelmate, and once you have registered
  29. the Shareware message will not be shown, and your users will be unaware of
  30. the origins of spelmate.
  31.  
  32. A number of sample programs in Borland C++, Borland Pascal, and Visual Basic 
  33. are included to illustrate how to use Spelmate. Spelmate is also used by
  34. Help Edit, a Windows Help File generation system, also from Aciran Software Systems.
  35.  
  36.  2. HOW TO GET HELP
  37. -------------------
  38.  
  39.   If you have any problems, please read this file and the user guide, and if
  40.   you still have a question and need assistance, help is available from the
  41.   following source:
  42.  
  43.      Write to me at the following address:
  44.  
  45.      James Herron
  46.      29 Duncryne Place,
  47.      Bishopbriggs
  48.      Glasgow G64 2DP
  49.      Scotland
  50.      UK.
  51.  
  52.   Alternatively call me on 041 762 0967 between 6pm and 9pm Mon - Fri, or any
  53.   time at Weekends (within reason!). Answering machine available.
  54.  
  55.   If you have a modem you can leave me a message on the ShareWare Support BBS
  56.   in the UK on (0442) 891109 (3 lines). This BBS has a link to the Runway BBS
  57.   in the US on 215-623-6203.
  58.  
  59.   Alternatively log on to a local BBS that echos FIDO or ILINK and leave me
  60.   a message in one of the following conferences:
  61.  
  62.   FIDO
  63.   ----
  64.   Shareware (fido)
  65.   Windows (fido)
  66.   Windows Programming (fido)
  67.  
  68.   ILINK
  69.   -----
  70.   Shareware (Ilink)
  71.   Windows Application Development (Ilink)
  72.  
  73.  
  74.   If you are on Compuserve or CIX you can Email me at
  75.  
  76.            herron@comms.eee.strathclyde.ac.uk  
  77.  
  78.   This is on the JANET network but can be accessed via internet and
  79.   Compuserve.
  80.   
  81.   To access internet you may have to make modifications such as:
  82.  
  83.                >INTERNET:herron@comms.eee.strathclyde.ac.uk
  84.  
  85.    which I BELIEVE is the correct format from Compuserve.  
  86.  
  87.  
  88.  3. INSTALLATION
  89. ----------------
  90.   You should read the rest of this README file to get further
  91.   information about this release before you do the installation.
  92.  
  93.   To perform the installation insert the floppy in drive A or B and run
  94.   INSTALL from Windows.
  95.   
  96.   This completes installation, you should now put your original disk(s) in a
  97.   save place. Start Windows and either run the demos from the Program Manager by
  98.   opening the File menu and selecting Run, or better still if you installed a
  99.   new group for Spelmate during install select it's icon for the application.
  100.  
  101.  4. IMPORTANT NOTES
  102. -------------------
  103.   o The Executable, dictionary and the Demo files in this package are
  104.     compressed. If you don't use the installation program or you need to
  105.     copy one of the original files onto your hard disk, use the UNPACK.EXE
  106.     file located on the distribution disk. This is a Windows application.
  107.  
  108.  
  109.  5. FILES ON THE DISK(S).
  110. -------------------------
  111.  
  112. Disk 1
  113.  
  114.   INSTALL  EXE    -  Windows Install Program
  115.   INSTALL  INF    -  Windows Install Script file
  116.   UNPACK   EXE    -  Unpack Utility.
  117.   README   DOC    -  This file
  118.   SPELMATE DL$    -  Spelmate DLL.
  119.   MAINxx   DI$    -  Main dictionary, either mainuk.dic or mainus.dic.
  120.   SPELMATE HL$    -  Spelmate user guide, this is a windows Help file.
  121.   SPELLAPP.EX$    -  Pascal Spell Editor
  122.   SPELLAPP.PA$    -  Pascal Spell Editor source
  123.   SPELLWND.PA$    -  Pascal Editor source
  124.   SPELLWND.RE$    -  Pascal Editor resource
  125.   SPELCHECK.EX$   -  Pascal File Speller
  126.   SPELCHECK.PA$   -  Pascal File Speller source
  127.   SPELL.PA$       -  Pascal Import Library
  128.   SPELFILE.RE$    -  Pascal Checker resource
  129.   INVOICE.DOC     -  Invoice/Order Form
  130.   FILEMENU.RC$    -  C Sample Filemenu resource
  131.   OWL.DE$         -  C Sample Owl def
  132.   SPELL.CP$       -  C Sample Spell.cpp
  133.   SPELL.IC$       -  C Sample Spell icon
  134.   SPELL.H$        -  C Sample Spell.h header
  135.   SPELLTST.EX$    -  C Spell Editor
  136.   SPELLTST.H$     -  C Sample header
  137.   SPELLTST.CP$    -  C Spell Editor source
  138.   SPELLTST.PR$    -  C Spell Editor project
  139.   SPELLTST.RC$    -  C Spell Editor resource
  140.   SPELMATE.BA$    -  Visual Basic interface
  141.   SPELMATE.H$     -  C Spelmate header
  142.   SPELMATE.LI$    -  C Import Library
  143.   GETFILE.FR$     -  VB Getfile form
  144.   SPELTEST.EX$    -  VB Spell Tester
  145.   SPELTEST.BA$    -  VB source
  146.   SPELTEST.MA$    -  VB Make File/Project
  147.   SAVEFILE.FR$    -  VB Savefile form
  148.   BOOK01A.IC$     -  VB Book Icon for examples
  149.   VBREADME.TX$    -  VB ReadMe File
  150.   VBSPLMIN.EX$    -  VB Min Example
  151.   VBSPLMIN.FR$    -  VB Min Form
  152.   VBSPLMIN.MA$    -  VB Min MakeFile
  153.  
  154. Note: all files whose extension ends in a $ are compressed.
  155.  
  156.  
  157. 6. Why Register?
  158. ----------------
  159.  
  160. Registering brings with it a number of advantages.
  161.  
  162. First of all the Unregistered Copy notice will no longer appear.
  163.  
  164. Second you will have technical support should you have any problems.
  165.  
  166. Third, your support will encourage me to continue to improve Spelmate.
  167.  
  168. And Finally, as a registered user you will be entitled to FREE updates for
  169. 6 months, and to favourable price reductions on future versions after that
  170. period. So make sure you complete the registration form as completely
  171. as possible.
  172.  
  173. 7. History
  174. ----------
  175. NB. Dates are in dd/mm/yy
  176.  
  177. 02/6/93 V1.0
  178. Initial release of Spelmate.
  179.  
  180.  
  181. 23/07/93 V1.1
  182.  
  183. Improved reliability by having Spelmate check the validity of the private
  184. dictionary, and deleting it if it is corrupt. Also a backup private
  185. dictionary was introduced to replace the corrupt one if needed.
  186.  
  187. This is not a bad reflection V1.0, it is simply that if your Application
  188. should crash during development,(don't they all!), it would leave the DLL in
  189. an unstable state, and usually corrupt the private dictionary. Spelmate
  190. would then not function correctly until this dictionary was deleted. It was
  191. not essential for your App to be spell checking at the time, the fact that
  192. it 'owned' the DLL at the time of it's demise was enough. These problems
  193. have now been overcome (by means of validation and backup) without any user
  194. intervention.
  195.  
  196. Spelmate V1.0 did not work correctly with C programs as the Boolean function
  197. SpellCheck returned a Pascal Boolean (byte) value, and not a 16 bit (word)
  198. value. It now uses a BOOL Windows (16bit word) value.
  199.  
  200. Spelmate V1.0 did not work with Visual Basic. This is because the function
  201. suggestWord expects a pointer to a string, and returns a pointer, and VB
  202. works with strings or arrays. This has been overcome with the addition of a
  203. new function SuggestVBWord which takes a string.
  204.  
  205. Murphy's Law states that the spell checking dialog box will nearly always
  206. manage to cover up the users view of the word you are trying to check.
  207.  
  208. Spelmate V1.0 allowed Windows to place the dialog box. V1.1 always places it
  209. in the bottom centre of the screen. Unless of course you call the procedure
  210. DisplayAtTop just before hand. You have to work out which half of the screen
  211. your word is in, then place the dialog box in the other. This is illustrated
  212. by a C and Pascal example.
  213.  
  214. Special thanks to Alistair McMonnies and Stewart McSporran of MEDC for the 
  215. C++ and VB examples.
  216.  
  217. 04/10/93 V1.2
  218.  
  219. Bug fix in Pascal file Spell checker, V1.1 does not automatically initialise
  220. Spelmate.
  221.  
  222. Bug fix in Visual Basic Text file editor. If cursor at first position and
  223. select spell check from cursor, got an invalid reference call error. fixed.
  224.  
  225.  
  226. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  227.              Aciran Software Products